home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Plus 1995 #5 & #6
/
Amiga Plus CD - 1995 - No. 5 and 6.iso
/
pd
/
serien
/
purity
/
nr.20
/
revmaker
/
revmaker.dok
< prev
next >
Wrap
Text File
|
1995-04-22
|
12KB
|
317 lines
###### ####### ## ## ## ## ### ## ## ####### ######
## ## ## ## ## ### ### ## ## ## ## ## ## ##
## ## #### ## ## ## # ## ## ## ##### #### ## ##
###### #### ## ## ## ## ####### ## ## #### ######
## ## ## #### ## ## ## ## ## ## ## ## ##
## ## ####### ## ## ## ## ## ## ## ####### ## ##
VERSION 1.100 (EINGESCHR. VERSION)
____________________________________
COPYRIGHT BY
BJOERN SCHOTTE
AM BURKARDSTUHL 45
97267 HIMMELSTADT
KONTOVERBINDUNG:
190 400 960
BLZ 79051580
Sparkasse Main-Spessart
_______________________________________________________________________________
===============================================================================
SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWA
===============================================================================
DIESE VERSION IST SHAREWARE. DIE VOLLVERSION IST FÜR DM 15.- PLUS PORTO (WOHN-
SITZ MUß INNERHALB DEUTSCHLANDS SEIN !!) BEI OBEN GENANNTER ADRESSE ERHÄLTLICH.
===============================================================================
SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWA
===============================================================================
======================================= INHALT ================================
1. Was ist RevMaker ?
2. Warum RevMaker ?
3. Wie werde ich RevMaker-USER
4. Getting started - Programmstart
5. Grüße, Danksagungen, etc...
6. Soon coming features...
7. Beispiel-Header
8. Fehlermeldungen
9. Über den Autor
10. Sonstiges
_______________________________________________________________________________
1. Was ist RevMaker ?
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
RevMaker ist ein Hilfsprogramm für Pascal-Programmierer,
denn RevMaker erzeugt vollautomatisch erstellte Revision-
header zu Deinem Programm (nur das Programm mußt Du
selbst schreiben !). Zusätzlich existiert noch eine
Backup-Funktion, bei der automatisch vor dem Erstellen
eine Kopie der Datei mit dem Namen Dateiname+".old" er-
stellt wird. Diese BackUp-Funktion kann je nach Belieben
ein- und ausgeschaltet werden.
2. Warum RevMaker ?
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Vorlage für dieses Programm war AutoRev, welches ich auf
irgendeiner Fish-Disk fand. Das Problem war, daß dieses
Programm OS2.X verlangte. Da ich nun [NOCH] kein OS2.X
habe, versuchte ich, mir dieses und ein anderes Programm
(aus der Kickstart; in Assembler programmiert) zum Vor-
bild zu nehmen und dieses Programm zu schaffen. Ich wich
davon ab, als erstes einen großen Speicherblock in der
Größe der Datei zu besorgen, da ich nicht wußte, wie man
dann den Versionsstring finden soll. Also erstellte ich
eine doppelt verkettete Liste.
Meine Ansprüche an das Programm:
- Komfortable Oberfläche im OS2.X-Stil
- Menü-Steuerung
- Iconify-Funktion
Tja, ich glaube, mir ist dies gelungen.
(Anmerkung: Getestet wurde RevMaker auf einem A500 mit 1MB
Speicher, 1 Disk-Drive. Es wurden keine nennenswerten Fehl-
funktionen festgestellt. Wer aber doch irgendwelche Fehler
findet, schnell zu mir schicken, damit ich ebenfalls schnell
ein Update rausbringen kann !!!)
ICH HAFTE NICHT FÜR IRGENDWELCHE SCHÄDEN, DIE DURCH REVMAKER HER-
VORGERUFEN WURDEN !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
3. Wie werde ich RevMaker-User
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Nun, dies ist mein erstes SHAREWARE-PROGRAMM, und ich
hoffe, daß viele RevMaker-User die Sharegebühr be-
zahlen. Sie beträgt übrigens 15 DM. Dafür bekommst Du
die Vollversion und wirst bei den zukünftigen Updates
benachrichtigt und kannst diese gegen einen kleinen
Betrag von mir erwerben.
Tja, Vollversion, richtig gelesen. Dies ist nämlich
eine eingeschränkte Version, bei der folgende Funk-
tionen gesperrt bzw. mit einem Nerv-Fenster belegt
sind:
Programm-Start (NERV-FENSTER)
Datei auswählen (NERV-FENSTER)
Programm-Ende (NERV-FENSTER)
Iconify (GESPERRT)
Ich habe mich dazu entschlossen, weil die Zahlungsmoral
hier in Deutschland nicht so gut ist wie z.B. in Amerika.
Also, wenn Dir das Programm gefällt und Du es benutzt,
dann wird die SHAREWARE-Gebühr fällig. Bist Du noch nicht
bei mir registriert, so schickst Du mir 15 DM oder eine
Überweisung (auf mein Konto). Natürlich
schickst Du mir noch den ausgefüllten Bogen mit (File
"Registrierung" !!).
Wenn ich deinen Bogen und das Geld erhalten habe, be-
kommst Du sofort die Vollversion von mir geschickt und
wirst als User registriert.
Sollte dann einmal eine neue Version fertiggestellt sein,
so schicke ich Dir eine Nachricht, daß eine neue Version
fertig ist. Willst Du diese Version haben, so kannst Du
sie bei mir für einen kleinen Betrag erwerben
(Upgradegebühr plus ein, zwei Mark für den Autor [mich]).
Folgt keine Antwort von Dir, so wird die
Upgrade-Benachrichtigung aus Kostengründen eingestellt.
Du bleibst aber nach wie vor registriert.
(Anmerkung: Siehe File "Registrierung" für genaue Er-
klärung !!)
4. Getting started - Programmstart
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Nach dem Programmstart von der Workbench/CLI (Vollversion:
Bei Workbench-Start könnt Ihr optional noch ein zweites
Icon mit anklicken (SHIFT-Klick auf zweites Icon-Doppel-
klick auf Programm-Icon), der Dateiname wird dann in das
Eingabefeld übernommen) öffnet sich das Hauptfenster und
dann ein Fenster, das anzeigt, daß Ihr die SHAREVERSION des
Programms benutzt (ca. 30 Sek. Wartezeit). Danach müßt nur
in dieses Fenster klicken und es verschwindet. Ihr seht
dann die Oberfläche vor euch. Das erste Gadget trägt die
Aufschrift "Datei..." und kann auch mit der Taste "D" aus-
gewählt werden. Nach der Auswahl dieser Funktion öffnet
sich der ARP-Filerequester und Ihr könnt eine Datei aus-
wählen. Bei Abbruch des Filerequesters bleibt natürlich der
alte Dateiname im Stringgadget erhalten !! Somit wären wir
auch beim zweiten Gadget: Das Dateinamen-Stringgadget. Hier
könnt Ihr auch ohne Filerequester den Dateiname eintragen.
Die nächsten Stringgadgets sind:
- Kommentar (Taste "K"): Hier ist ein bis zu 255 Zeichen
langer Kommentar einzugeben. Sollte der Kommentar
länger als 30 Zeichen sein, so wird automatisch ge-
trennt. Bei der ersten Generierung eines Revision-
headers werden die Felder Kommentar und Version NICHT
berücksichtigt (Kommentar ist dann:
"- Initial release -"; Version: "V0.000" )
- Autor: Hier kommt der Name des Autors rein.
(max. 30 Zeichen)
- Copyright: Hier könnt Ihr Copyright-Vermerke eintragen.
(max. 26 Zeichen)
- Version: Ein bis zu sechs Zeichen langer String, der die
Version angibt (z.B. "ALPHA" oder "v1.234",...).
- Purpose: Die eigentliche Funktion des Programms, das
diesen Header verpasst bekommt (wird beim Updaten NICHT be-
rücksichtigt !). (max. 80 Zeichen)
Dann haben wir ein Cycle-Gadget, über das man die Backup-
Funktion einstellen kann. Bei aktiviertem BackUp wird
zuerst eine Kopie der Datei mit dem Namen: Dateiname+".old"
erstellt.
Der nächste Schalter ist "START". Klickt Ihr diesen Schalter
an, wird, sofern BackUp aktiviert ist, ein BackUp-File er-
zeugt, dann die Datei in den Speicher gelesen und dann,
je nachdem, ob schon ein Revision-Header existiert, ein
neuer Header angelegt oder ge-updated. Der Header kann
dabei an jeder beliebigen Stelle im Quelltext stehen
(muß aber in SPALTE 1 stehen!) !!
Neben diesem Gadget ist noch ein weiteres mit dem Namen "Save Prefs".
Es speichert den Autor und den Copyrighter in die Datei ":s/RevMaker.cfg"
und es wird versucht, diese Config-Datei bei jedem RevMaker-Start zu
laden. Konnte man diese nicht laden, werden die "Default-Einstellungen"
benutzt (eigentlich Schwachsinn, aber was soll`s !). Dieses Gadget kann
auch über die Taste <R> angewählt werden...
Das STATUS-Feld (ganz unten) informiert euch, was gerade
passiert. Sollte während dem Einlesen der Datei plötzlich
das Fenster geschlossen und das Programm beendet werden,
so ist das kein Programmfehler, nein, das liegt daran, daß
kein Speicher zur Verfügung steht, um die Datei in den
Speicher zu lesen. Beendet also noch laufende Programme bzw.
macht irgendwie den Speicher frei und startet das Programm
nochmal. Dann müßte es laufen.
5. Grüße, Danksagungen etc...
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Grüße gehen an:
Robert Martignoni und Diesel (für die sagenhaften P.U.R.I.T.Y.s,
macht weiter so !!),
Røgersøft alias Michael Klein (Danke für die tollen Border-Rou-
tinen und Drucky und, natürlich, Røgerdat !!!)
Und an alle, die ich vergessen hab` !!!
6. Soon coming features...
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Tja, was wäre noch wünschenswert ?
- ONLINE-Hilfe,
- ...
7. Beispiel-Header
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Hier ein Beispiel-Header, das Datum wird jeweils immer auto-
matisch eingefügt (nicht täuschen lassen, daß alle Daten auf
den 19.09. zeigen, ich habe diesen Header auf einmal an einem
Tag erstellt ! Normalerweise sind dann hier mehrere Daten vorhanden !).
{ ****** Auto-Revision (do NOT edit) ********************
*
* © Copyright by BOMBERSOFT
*
* Filename : RAM DISK:Beispiel
* Created on : 19.09.1993
* Created by : Björn Schotte
* Current revision : V1.100
*
*
* Purpose: Beispiel-Header
*
*
* V1.100 : 19.09.1993 : Es ist nicht leicht, ein
* perfektes Programm zu
* schreiben, aber einer muß es
* ja mal machen !!
*
* V1.070 : 19.09.1993 : Jetzt sogar mit
* Pseudo-OS2.0-Oberfläche !!
*
* V1.050 : 19.09.1993 : Ich dachte, ich gönne dem
* User mal eine Trennfunktion,
* damit er auch mal längere
* Kommentare eingeben kann...
*
* V0.000 : 19.09.1993 : - Initial release -
******************************************************* }
8. Fehlermeldungen
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Folgende Fehlermeldungen sind während des Betriebs von RevMaker
möglich:
SCHREIB/LESEFEHLER NR. ####: Dieser Fehler tritt aus, wenn
beim Createn oder Updaten des Headers und anschliessendem
Schreiben der Datei ein Fehler auftritt. Übergeben wird die
Fehlernummer (Diese kann man in verschiedenen Büchern finden
oder aber mit meinem Programm "Huh" von der P.U.R.I.T.Y. 8
finden !).
Der Fehler mit dem Schliessen des Fensters habe ich bereits
erklärt.
9. Über den Autor
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Tja, damit auch alle mal wissen, wer ich bin, hier eine kleine
Vorstellung:
Name: Björn Schotte
Geburtstag: 30.09.1978
Aussehen: Vollschlank, Brillenträger, Linkshänder
Hobbys: - Compi,
- Lesen,
- Musik hören (meistens Techno, aber auch sonst alles
außer Volksmusik !)
- Radfahren (nich so oft)
- Schwimmen (auch nicht so oft)
- nochmal Compi
Computer-Equipment:
Amiga 500, 1MB Speicher, 1 Disk-Drive,
Drucker: Fujitsu DL1100 (saugeiles Ding, sag` ich euch !),
Monitor: 1084S (würgh..)
und bald (so in 1-2 Wochen:)
Amiga 4000 mit 86EC030-Prozessor und 4MB RAM, 1 Disklaufwerk.
(OS3.0).
Dann werden auch alle meine anderen Programme getestet und,
wenn ich mit der GadTools.library in Einklang gekommen bin,
auch RevMaker mit einer GadTools-Oberfläche gestaltet wird.
(Auch das PurityMag wird warscheinlich eine solche Änderung
beinhalten, aber auch weiterhin unter OS1.x laufen !!)
10. Sonstiges
¯¯¯¯¯¯¯¯¯¯¯¯¯
Also, Leute, zahlt die Sharegebühr !!
C U in next proggy, yours, Björn !!